home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / X11 / libxrx.z / libxrx
Encoding:
Text File  |  2001-04-17  |  10.2 KB  |  199 lines

  1.  
  2.  
  3.  
  4.      LLLLIIIIBBBBXXXXRRRRXXXX((((1111))))          XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))           LLLLIIIIBBBBXXXXRRRRXXXX((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           libxrx - RX Netscape Navigator Plug-in
  10.  
  11.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.           The RRRRXXXX PPPPlllluuuugggg----iiiinnnn may be used with Netscape Navigator (3.0 or
  13.           later) to interpret documents in the RX MIME type format and
  14.           start remote applications.
  15.  
  16.           The RRRRXXXX PPPPlllluuuugggg----iiiinnnn reads an RX document, from which it gets the
  17.           list of services the application wants to use. Based on this
  18.           information, the RRRRXXXX PPPPlllluuuugggg----iiiinnnn sets the various requested
  19.           services, including creating authorization keys if your X
  20.           server supports the SECURITY extension. It then passes the
  21.           relevant data, such as the X display name, to the
  22.           application through an HTTP GET request of the associated
  23.           CGI script. The Web server then executes the CGI script to
  24.           start the application. The client runs on the web server
  25.           host connected to your X server. In addition when the RX
  26.           document is used within the EMBED tag (a Netscape extension
  27.           to HTML), the RRRRXXXX PPPPlllluuuugggg----iiiinnnn uses the XC-APPGROUP extension, if
  28.           it is supported by your X server, to cause the remote
  29.           application to be embedded within the browser page from
  30.           which it was launched.
  31.  
  32.      IIIINNNNSSSSTTTTAAAALLLLLLLLAAAATTTTIIIIOOOONNNN
  33.           The RRRRXXXX PPPPlllluuuugggg----iiiinnnn is installed as libxrx.so in
  34.           /var/netscape/communicator/plugins. An N32 version is also
  35.           installed in /var/netscape/communicator/plugins32.
  36.  
  37.           If you have configured Netscape Navigator to use the RX
  38.           helper program (xxxxrrrrxxxx)(not shipped by SGI), you must
  39.           reconfigure it. Generally you simply need to remove or
  40.           comment out the line you may have previously added in your
  41.           mailcap file to use the RX helper program.  Otherwise the
  42.           plug-in will not be enabled. (The usual comment character
  43.           for mailcap is ``#''.)
  44.  
  45.           If you are already running Netscape Navigator, you need to
  46.           exit and restart it after copying the plug-in library so the
  47.           new plug-in will be found.  Once this is done you can check
  48.           that Navigator has successfully loaded the plug-in by
  49.           checking the ``About Plug-ins'' page from the Help menu.
  50.           This should show something like:
  51.  
  52.                                       RX Plug-in
  53.  
  54.               File name: /var/netscape/communicator/plugins/libxrx.so
  55.  
  56.               X Remote Activation Plug-in
  57.  
  58.               Mime Type         Description                  Suffixes
  59.           Enabled
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 4/6/01)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      LLLLIIIIBBBBXXXXRRRRXXXX((((1111))))          XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))           LLLLIIIIBBBBXXXXRRRRXXXX((((1111))))
  71.  
  72.  
  73.  
  74.               application/x-rx  X Remote Activation Plug-in  rx
  75.           Yes
  76.  
  77.  
  78.           Once correctly configured, Netscape Navigator will activate
  79.           the RRRRXXXX PPPPlllluuuugggg----iiiinnnn whenever you retrieve any document of the
  80.           MIME type _a_p_p_l_i_c_a_t_i_o_n/_x-_r_x.
  81.  
  82.      RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  83.           The RRRRXXXX PPPPlllluuuugggg----iiiinnnn looks for resources associated with the
  84.           widget nnnneeeettttssssccccaaaappppeeee....NNNNaaaavvvviiiiggggaaaattttoooorrrr ((((class NNNNeeeettttssssccccaaaappppeeee....TTTTooooppppLLLLeeeevvvveeeellllSSSShhhheeeellllllll)))) and
  85.           understands the following resource names and classes:
  86.  
  87.           xxxxrrrrxxxxHHHHaaaassssFFFFiiiirrrreeeewwwwaaaallllllllPPPPrrrrooooxxxxyyyy ((((class XXXXrrrrxxxxHHHHaaaassssFFFFiiiirrrreeeewwwwaaaallllllllPPPPrrrrooooxxxxyyyy))))
  88.                   Specifies whether an X server firewall proxy (see
  89.                   xfwp) is running and should be used. Default is
  90.                   ``False.''
  91.  
  92.           xxxxrrrrxxxxIIIInnnntttteeeerrrrnnnnaaaallllWWWWeeeebbbbSSSSeeeerrrrvvvveeeerrrrssss ((((class XXXXrrrrxxxxIIIInnnntttteeeerrrrnnnnaaaallllWWWWeeeebbbbSSSSeeeerrrrvvvveeeerrrrssss))))
  93.                   The web servers for which the X server firewall
  94.                   proxy should not be used (only relevant when
  95.                   xxxxrrrrxxxxHHHHaaaassssFFFFiiiirrrreeeewwwwaaaallllllllPPPPrrrrooooxxxxyyyy is ``True''). Its value is a
  96.                   comma separated list of mask/value pairs to be used
  97.                   to filter internal web servers, based on their
  98.                   address. The mask part specifies which segments of
  99.                   the address are to be considered and the value part
  100.                   specifies what the result should match. For instance
  101.                   the following list:
  102.  
  103.                         255.255.255.0/198.112.45.0,
  104.                   255.255.255.0/198.112.46.0
  105.  
  106.                   matches the address sets: 198.112.45.* and
  107.                   198.112.46.*. More precisely, the test is (address &
  108.                   mask) == value.
  109.  
  110.           xxxxrrrrxxxxFFFFaaaassssttttWWWWeeeebbbbSSSSeeeerrrrvvvveeeerrrrssss ((((class XXXXrrrrxxxxFFFFaaaassssttttWWWWeeeebbbbSSSSeeeerrrrvvvveeeerrrrssss))))
  111.                   The web servers for which LBX should not be used.
  112.                   The resource value is a list of address mask/value
  113.                   pairs, as previously described.
  114.  
  115.           xxxxrrrrxxxxTTTTrrrruuuusssstttteeeeddddWWWWeeeebbbbSSSSeeeerrrrvvvveeeerrrrssss ((((class XXXXrrrrxxxxTTTTrrrruuuusssstttteeeeddddWWWWeeeebbbbSSSSeeeerrrrvvvveeeerrrrssss))))
  116.                   The web servers from which remote applications
  117.                   should be run as trusted clients. The default is to
  118.                   run remote applications as untrusted clients. The
  119.                   resource value is a list of address mask/value
  120.                   pairs, as previously described.
  121.  
  122.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  123.           If the RX document requests X-UI-LBX service and the default
  124.           X server does not advertise the LBX extension, the _R_X _P_l_u_g-
  125.           _i_n will look for the environment variable ``XREALDISPLAY''
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 4/6/01)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      LLLLIIIIBBBBXXXXRRRRXXXX((((1111))))          XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))           LLLLIIIIBBBBXXXXRRRRXXXX((((1111))))
  137.  
  138.  
  139.  
  140.           to get a second address for your X server and look for the
  141.           LBX extension there. When running your browser through
  142.           _l_b_x_p_r_o_x_y you will need to set XREALDISPLAY to the actual
  143.           address of your server if you wish remote applications to be
  144.           able to use LBX across the Internet.
  145.  
  146.           If the RX document requests XPRINT service, _R_X _P_l_u_g-_i_n looks
  147.           for the variable ``XPRINTER'' to get the printer name and X
  148.           Print server address to use. If the server address is not
  149.           specified as part of XPRINTER, _R_X _P_l_u_g-_i_n uses the first one
  150.           specified through the variable ``XPSERVERLIST'' when it is
  151.           set. When it is not _R_X _P_l_u_g-_i_n then tries to use the video
  152.           server as the print server. If the printer name is not
  153.           specified via XPRINTER, _R_X _P_l_u_g-_i_n looks for it in the
  154.           variables ``PDPRINTER'', then ``LPDEST'', and finally
  155.           ``PRINTER'',
  156.  
  157.           Finally, if you are using a firewall proxy, _R_X _P_l_u_g-_i_n will
  158.           look for ``PROXY_MANAGER'' to get the address of your proxy
  159.           manager (see proxymngr). When not specified it will use
  160.           ":6500" as the default.
  161.  
  162.      KKKKNNNNOOOOWWWWNNNN BBBBUUUUGGGG
  163.           When an authorization key is created for a remote
  164.           application to use the X Print service, the RRRRXXXX PPPPlllluuuugggg----iiiinnnn has
  165.           to create the key with an infinite timeout since nobody
  166.           knows when the application will actually connect to the X
  167.           Print server. It then revokes the key when its instance is
  168.           destroyed (that is when you go to another page). However, if
  169.           the Plug-in does not get destroyed properly, which happens
  170.           when Netscape Navigator dies unexpectedly, the print
  171.           authorization key will never get revoked.
  172.  
  173.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  174.           xrx (1), xfwp (1), lbxproxy (1), proxymngr (1), The RX
  175.           Document specification
  176.  
  177.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  178.           Arnaud Le Hors and Kaleb Keithley, X Consortium
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 4/6/01)
  196.  
  197.  
  198.  
  199.